sequenceDiagram
    participant Client
    participant WebhookRoute
    participant Processor
    participant PreprocessExecution
    participant DB
    participant Logger
    participant RateLimiter
    participant BillingService

    Client->>WebhookRoute: POST webhook request
    WebhookRoute->>Processor: checkWebhookPreprocessing(isTestMode)
    Processor->>PreprocessExecution: preprocessExecution(checkDeployment=!isTestMode)
    
    Note over PreprocessExecution: STEP 1: Validate Workflow Exists
    PreprocessExecution->>DB: SELECT workflow
    DB-->>PreprocessExecution: workflow record
    
    Note over PreprocessExecution: STEP 2: Check Deployment (BEFORE logging!)
    alt Deployment check enabled AND workflow not deployed
        PreprocessExecution-->>Processor: Error (403, logCreated: false)
        Processor-->>WebhookRoute: NextResponse error
        WebhookRoute-->>Client: 403 Unauthorized
    else Deployment check passed or skipped
        Note over PreprocessExecution: STEP 3: Resolve Billing Actor
        PreprocessExecution->>BillingService: getWorkspaceBilledAccountUserId()
        BillingService-->>PreprocessExecution: actorUserId
        
        Note over PreprocessExecution: STEP 4-6: Rate & Usage Limits
        PreprocessExecution->>RateLimiter: checkRateLimitWithSubscription()
        RateLimiter-->>PreprocessExecution: rate limit result
        
        alt Rate limit exceeded
            PreprocessExecution->>Logger: Log preprocessing error
            PreprocessExecution-->>Processor: Error (429, logCreated: true)
        else All checks passed
            PreprocessExecution-->>Processor: Success
            Processor-->>WebhookRoute: null (no error)
            WebhookRoute->>WebhookRoute: queueWebhookExecution()
            WebhookRoute-->>Client: 200 OK
        end
    end